fix: inherit @SimpleBuilder options from parent classes (#248) - #21 - #252

…ance

Rename SimpleBuilderInheritanceTest to BuilderAnnotationInheritanceTest
so the name reflects that it covers both builder-triggering annotations.
Add unannotatedSubclassGetsBuilderFromInheritedTemplate, which verifies
that a custom @inherited template annotation (meta-annotated with
@SimpleBuilder.Template) propagates to unannotated subclasses, matching
the existing behaviour of @SimpleBuilder itself.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

The Template Javadoc and CONFIGURATION.md "Template Annotations" section
did not explain that @SimpleBuilder.Template is @inherited, nor that a
custom template annotation must additionally declare @inherited to
propagate to unannotated subclasses. Add explicit documentation and an
example showing the @inherited custom annotation pattern.

Also move assertNoBuilderGenerated to ProcessorAsserts so it is shared
by BuilderAnnotationInheritanceTest and Ignore4BuilderGenerationTest
instead of being duplicated as a private helper in each test class.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

While @SimpleBuilder and @inherited template annotations now correctly
trigger builder generation for unannotated subclasses, the configuration
options declared on the parent's @SimpleBuilder(options = ...) or template
are not yet applied to inherited subclass builders — they use default
options instead. This is tracked separately in issue java-helpers#245.

Add caveats to the SimpleBuilder Javadoc, the CONFIGURATION.md Template
Annotations section, and the Template Annotations Not Working
troubleshooting section so users are not surprised by this limitation.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

Add explicit guidance that @SimpleBuilder.Template is a meta-annotation
for custom annotation declarations (@interface) only and cannot be
placed directly on a class or record. @SimpleBuilder is for direct
one-off annotation of classes/records.

- SimpleBuilder.java: add 'When to use' section to class-level Javadoc
- SimpleBuilder.Template Javadoc: state it can only be placed on
  annotation types (ANNOTATION_TYPE), not on classes/records
- CONFIGURATION.md 'Template Annotations': add comparison table and
  introductory paragraph
- CONFIGURATION.md troubleshooting: add item about @SimpleBuilder.Template
  not being a class annotation

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

…Javadoc

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

…arget

The compiler and IDE already enforce @target(ANNOTATION_TYPE) and show
a clear error when @SimpleBuilder.Template is placed on a class/record,
so this troubleshooting item adds no value.

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

…#248)

BuilderConfigurationReader used element.getAnnotationMirrors(), which only
returns directly-declared annotations. This caused unannotated subclasses of
an annotated parent to get a builder with default options instead of the
parent's @SimpleBuilder(options=...) or template-annotation options.

Switch the three configuration-reading methods to
Elements.getAllAnnotationMirrors(element), which includes @inherited
annotations from superclasses.

Add regression tests in BuilderAnnotationInheritanceTest covering both
@SimpleBuilder and custom template annotation option inheritance.

Update SimpleBuilder Javadoc and CONFIGURATION.md to document that options
are inherited too.

Closes java-helpers#248

Co-Authored-By: Andreas Igel <andreas.igel@computacenter.com>

… ones

- Introduce AnnotationScope (DIRECT/INHERITED) in BuilderConfigurationReader.
- Resolve config in precedence order: defaults < globals < inherited template <
  inherited @SimpleBuilder < direct template < direct @SimpleBuilder.
- Only ignore template annotations in the same scope where @SimpleBuilder is
  declared, preventing an inherited @SimpleBuilder from suppressing a subclass's
  own template.
- Add regression tests in BuilderAnnotationInheritanceTest for a subclass
  template overriding inherited @SimpleBuilder options and inherited template
  options.
- Align junit-jupiter.version to 6.0.3 (6.1.2 is not published) so the test suite
  can resolve.
- Update debug-message expectation in BuilderProcessorTest.

Co-Authored-By: Andreas Igel <andreas.igel@computacenter.com>

…ce fix

Co-Authored-By: Andreas Igel <andreas.igel@computacenter.com>

…ts actually run

Co-Authored-By: Andreas Igel <andreas.igel@computacenter.com>

Co-Authored-By: Andreas Igel <andreas.igel@computacenter.com>

Co-Authored-By: Andreas Igel <andreas.igel@computacenter.com>